Fork me on GitHub

Markdown 语法(精简版)


节选自Markdown官方文档

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。 —— [ 维基百科 ]

标题层级

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),例如:
This is an H1
=============
This is an H2
-------------
任何数量的 = 和 - 都可以有效果。
类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:
# 这是 H1
## 这是 H2
###### 这是 H6
你可以选择性地「闭合」类 atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的 # 数量也不用和开头一样(行首的井字符数量决定标题的阶数):
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######

无序列表

可以使用+,-,*做为列表的项目标记,列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。

加粗

形如:**test**, test

斜体

形如:*test*, test

插入链接

1. 形如:[xxx](http://www.baidu.com) , xxx
2. 参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记,This is [an example][id] reference-style link,接着,在文件的任意处,你可以把这个标记的链接内容定义出来,[id]: http://example.com/ "Optional Title Here"
This is an example reference-style link.

插入图片

很明显地,要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
行内式的图片语法看起来像是:
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
详细叙述如下:
1.一个惊叹号 !
2.接着一个方括号,里面放上图片的替代文字
3.接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 ‘title’ 文字。
参考式的图片语法则长得像这样:
![Alt text][id]
「id」是图片参考的名称,图片参考的定义方式则和连结参考一样:
[id]: url/to/image "Optional title attribute"
到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img> 标签。
eg:
<img src="/blog_pic/HeadPic.jpg" height="200" width="200" />

插入代码

要在 Markdown 中建立代码区块很简单,只要简单地使用三个反引号即可,如下例所示
this is normal part。
```
this is code part。
```
表示为:
this is normal part。

1
this is code part。

要想在文字中见插入简短的代码,只需在代码的开始和结束各使用单个反引号即可。

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号
例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 标签),你可以在星号的前面加上反斜杠:\*literal asterisks\*,表示为*literal asterisks*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

符号 意义
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
Enjoy it ? Donate for it ! 欣赏此文?求鼓励,求支持!
>